home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / scale.z / scale
Encoding:
Text File  |  2002-10-03  |  3.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ssssccccaaaalllleeee((((3333GGGG))))                                                            ssssccccaaaalllleeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ssssccccaaaalllleeee - scales and mirrors the current matrix
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ssssccccaaaalllleeee((((xxxx,,,, yyyy,,,, zzzz))))
  13.      rrrreeeeaaaallll xxxx,,,, yyyy,,,, zzzz
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _x   expects the scale factor in the x direction.
  17.  
  18.      _y   expects the scale factor in the y direction.
  19.  
  20.      _z   expects the scale factor in the z direction.
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      ssssccccaaaalllleeee modifies the current matrix, causing it to shrink, expand, or
  24.      mirror coordinates that it transforms.  Values with a magnitude greater
  25.      than 1 result in expansion; values with a magnitude less than 1 cause
  26.      shrinkage.  Negative values result in mirrored coordinates.
  27.  
  28.      The _x, _y, and _z scale factors are used to compute a 4x4 scale matrix,
  29.      which then premultiplies the current matrix, as specified by mmmmmmmmooooddddeeee.  Thus
  30.      if _T is the current matrix, and _S is the matrix computed by ssssccccaaaalllleeee, _T is
  31.      replaced with _S*_T.
  32.  
  33.      The current matrix is the top matrix on the transformation stack if mmmmmmmmooooddddeeee
  34.      is MMMMSSSSIIIINNNNGGGGLLLL, the top matrix on the ModelView matrix stack if mmmmmmmmooooddddeeee is
  35.      MMMMVVVVIIIIEEEEWWWWIIII, the Projection matrix if mmmmmmmmooooddddeeee is MMMMPPPPRRRROOOOJJJJEEEE, or the Texture matrix
  36.      if mmmmmmmmooooddddeeee is MMMMTTTTEEEEXXXXTTTTUUUU.
  37.  
  38.      All objects drawn after ssssccccaaaalllleeee is called while mmmmmmmmooooddddeeee is either MMMMSSSSIIIINNNNGGGGLLLL or
  39.      MMMMVVVVIIIIEEEEWWWWIIII are scaled.  Use ppppuuuusssshhhhmmmmaaaa and ppppooooppppmmmmaaaatttt to preserve and restore the
  40.      unscaled coordinate system.
  41.  
  42. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  43.      mmode, popmat, pushma, rotate, transl
  44.  
  45. NNNNOOOOTTTTEEEESSSS
  46.      Matrices that negate coordinates, such as ssssccccaaaalllleeee (-1.0, 1.0, 1.0), reverse
  47.      the directional order of a polygon's points and can cause the opposite of
  48.      what is intended.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.